Fox's Git Mirrors
>The Non-linear Task Manager
A functional approach to task management that works with your brain. T383838nt breaks free from chronological and rigid to-do lists, and lets you organize anything as a dynamic web of interconnected dependencies that mirror how projects actually unfold.
Unlike traditional task managers that force linear thinking, T383838nt embraces the chaotic, branching nature of real work. Tasks don't just sit in isolation, but form living hierarchies where complex projects decompose into manageable fragments, and where ML models can analyze and operate on your entire workflow with contextual understanding.
Built for power users and ML-based systems alike, T383838nt uses atomic file storage for dependency-based planning. Every task is an independent msgpack file, ensuring your data's integrity while maintaining fast performance through intelligent caching.
Whether you're working on software, planning a research project, or just trying to organize your thoughts, T383838nt provides the tools to think in systems rather than sequences.
Key Features
• Dependency-Based Architecture: Tasks form organic hierarchies that reflect real project structures
• Atomic Persistence: Each task stored as a single immutable file with immediate disk writes
• Rich Task States: Pending, In Progress, Completed, Cancelled, Deleted, Archived
• Smart Auto-completion: Tasks that complete automatically when dependencies are satisfied
• Workspace Isolation: Separate contexts for different projects with clone capabilities
• Instant Checkpoints: Snapshot and restore your entire task state with single commands
• Universal CLI Syntax: Contextual commands (T383838nt 7 needs 3) that read like natural language
• Batch Operations: Perform actions on multiple tasks simultaneously
• Visual Hierarchy Rendering: Unicode, Nerd Font, or ASCII tree displays with state indicators
• Weighted Progress Tracking: Intelligent completion metrics that respect task importance
• Priority-Based Sorting: Tasks ordered by importance, not just creation time
• External Editing: Edit task descriptions in your preferred editor
• LLM-Powered Analysis: Query your task graph with LLMs for insights, summaries, task execution and planning
• Prompt Templates: Customizable prompts for different query types
Useful For
• Software developers managing complex feature dependencies
• Researchers orchestrating multi-phase projects
• Project managers coordinating interdependent deliverables
• Knowledge workers with non-linear thought processes
• ML-based systems requiring structured task understanding
• Anyone who's ever felt constrained by chronological to-do lists
Installation
T282828
pip install nt-1.0.0-py3-none-any.whl
Quick Start
T282828
# Add tasks
nt add "Buy groceries"
nt add "Cook dinner" -d 1
# View tasks
nt 1 # Show details for task 1 (contextual syntax)
nt 1,2,3 # Show multiple tasks
nt list # List active tasks
# Manage task states
nt start 2 # Start task 2
nt complete 1 # Complete task 1
nt stop 2 # Stop task 2
# Manage dependencies
nt 1 needs 3 # Add task 3 as dependency for task 1
nt needs 1 3,4 # Add tasks 3 and 4 as dependencies for task 1
Commands
Task Creation
T282828
# Add a single task
nt add "Task description"
# Add multiple tasks
nt add "Task 1" "Task 2" "Task 3"
# Add tasks with dependencies
nt add "Dependent task" -d 1 2 3
# Add tasks as dependencies FOR another task
nt add "Subtask 1" "Subtask 2" -f 5
# Read description from stdin
nt add
# (Enter description and press Ctrl+D)
Task Management
T282828
# View tasks (both syntaxes work identically)
nt 1 # Show task 1 (contextual)
nt show 1 # Explicit show command
nt 1,2,3 # Show multiple tasks
nt show 1,2,3 # Explicit show for multiple tasks
# Recursive display
nt 1 -r # Show task with full dependency tree
nt 1 --depth 2 # Show task with 2 levels of dependencies
# Edit task description
nt edit 1 "New description" # Direct edit
nt edit 1 # Open in external editor
# State management (all support comma-separated IDs)
nt start 1,2,3 # Start tasks
nt stop 1,2,3 # Stop tasks
nt complete 1,2,3 # Complete tasks
nt cancel 1,2,3 # Cancel tasks
nt delete 1,2,3 # Delete tasks
nt archive 1,2,3 # Archive tasks
nt unarchive 1,2,3 # Unarchive tasks
# Task properties
nt weight 5 2.0 # Set task weight
nt priority 5 3 # Set task priority
nt type 5 composite # Set task type
nt autocomplete 5 all # Set auto-complete mode
nt progress 5 # Show detailed progress
Dependency Management
T282828
# Add dependencies (contextual and explicit syntax)
nt 1 needs 3 # Add task 3 as dependency for task 1
nt needs 1 3,4,5 # Add multiple dependencies
nt needs 1,2 3 # Add dependency to multiple tasks
# Remove dependencies
nt 1 detach 3 # Remove task 3 as dependency from task 1
nt detach 1 3,4,5 # Remove multiple dependencies
Task Listing
T282828
nt list # List active top-level tasks only
nt list --all # Include completed/cancelled tasks
nt list --flat # Flat list of all tasks (not hierarchical)
nt list -r # Show with dependency trees
nt list --depth 2 # Show with 2 levels of dependencies
nt list --progress # Show progress for composite tasks
Workspaces
T282828
nt workspace # List all workspaces
nt workspace myproject # Switch to or create workspace
nt workspace --delete old # Delete workspace
nt workspace --clone existing new # Clone workspace
Checkpoints
T282828
nt checkpoint # Create checkpoint with auto name
nt checkpoint "v1.0" # Create named checkpoint
nt checkpoint list # List all checkpoints
nt checkpoint restore 1 # Restore from checkpoint
nt revert # Revert to latest checkpoint
Configuration
T282828
nt config list # Show current configuration
nt config get icon_style # Get specific config value
nt config set icon_style nerd # Set config value
nt config reset # Reset to defaults
LLM Integration
T282828
# Query tasks with LLM
nt query "What should I work on next?" # Query all tasks
nt query 1,2,3 "Analyze these tasks" # Query specific tasks
nt query 1 -r "Summarize this task tree" # Query with dependencies
# Interactive query mode
nt query # Enter interactive mode
# Manage LLM models
nt model list # List configured models
nt model add --name "Local Qwen" --model qwen3_235b --client openai --api_url http://localhost:8000
nt model default 1 # Set default model
# Manage prompt templates
nt prompt list # List templates
nt prompt create analysis # Create new template
nt prompt use analysis # Set active template
Maintenance
T282828
nt purge # Permanently delete tasks marked as deleted
nt clean # Remove dependencies that no longer exist from dependent tasks
Task States
• Pending (○): Default state for new tasks
• In Progress (◐): Task is currently being worked on
• Completed (●): Task is finished
• Cancelled (⊘): Task was cancelled
• Deleted (✕): Task marked for deletion (use purge to remove permanently)
• Archived (▽): Task is archived for reference
Task Types
• Regular : Standard task with no special behavior
• Composite : Task that can auto-complete based on dependency status
• Milestone : Significant checkpoint or deliverable
Auto-complete Modes
• None : Task must be manually completed
• All Dependencies : Task auto-completes when all dependencies are complete
• Percent Dependencies : Task auto-completes when specified percentage of dependencies are complete
Configuration
The T383838EDITOR environment variable is used for the edit command. If not set, defaults to T383838vi.
Data is stored in T383838~/.nt/ by default.
Configuration options:
• T383838icon_style: Display style ('unicode', 'nerd', 'ascii')
• T383838llm_icon_style: Icon style used in LLM queries ('unicode', 'nerd', 'ascii')
Examples
T282828
# Complex workflow
nt add "Plan vacation"
nt add "Book flights" "Book hotel" "Pack suitcase" -f 1
nt add "Find lost credit card"
nt 3 needs 5
nt start 1
nt complete 2
nt show 1 -r
# Workspace management
nt workspace project1
nt add "Project tasks"
nt workspace project2
nt add "Different project"
# Checkpoint for backup
nt checkpoint "Before major refactor"
# ... do risky changes ...
nt revert # If something goes wrong
# LLM analysis
nt query "Which tasks are blockers for my main project?"
nt query 1 -r --depth 3 "Analyze this dependency tree"
nt query --template summarize # Use specific prompt template
Design Philosophy
• Atomic Operations: Every task is a single file that can be managed independently
• Immediate Persistence: Changes are written to disk immediately
• Memory Efficient: Active tasks are cached, inactive tasks are loaded on demand
• Dependency Aware: Smart dependency validation prevents circular dependencies
• CLI Optimized: Commands are designed for both interactive and scripted use
• Contextual Syntax: Natural language-like commands (T383838nt 1 needs 3)
• Visual Clarity: Concise, symbolic output with intuitive hierarchical display
• ML Enhanced: Solid technical foundation, enhanced with LLM integration for analysis and insights
License & Support
See LICENSE.md for details. You can help support the continued development of T383838nt by donating via one of the following channels:
• Monero:
T282828
84FpY1QbxHcgdseePYNmhTHcrgMX4nFfBYtz2GKYToqHVVhJp8Eaw1Z1EedRnKD19b3B8NiLCGVxzKV17UMmmeEsCrPyA5w
• Bitcoin
T282828
bc1pgqgu8h8xvj4jtafslq396v7ju7hkgymyrzyqft4llfslz5vp99psqfk3a6
• Ethereum
T282828
0x91C421DdfB8a30a49A71d63447ddb54cEBe3465E
• Liberapay
T282828
https://liberapay.com/Reticulum/
• Ko-Fi:
T282828
https://ko-fi.com/markqvist
Sample Outputs
Here's an example of T383838nt's output of a project management snapshot for T383838nt itself:
T282828
❯ nt 7 -r
◐ 7 Non-Linear Task Manager
├─◐ 1 Basic implementation of nt
│ ├─● 75 Refactor codebase into separate files
│ ├─● 50 Sort by priority
│ ├─● 2 Implement workspaces
│ ├─● 3 Implement configuration
│ ├─● 4 Add auto-complete option
│ │ ├─● 3 Implement configuration
│ │ └─● 31 Implement "goal", "composite" or similar
│ ├─● 5 Add shorthand commands
│ ├─● 15 Show notes below dependencies for task show
│ ├─● 19 Show only top-level tasks on list command
│ ├─● 27 Add recursive depth option to recursive display
│ ├─● 33 Improve management flow
│ │ ├─● 34 Add archiving operations
│ │ ├─● 35 Add sane filters to task show, so archived, cancelled, etc. is hidden
│ │ └─● 36 Add flag for displaying archived (etc.) tasks on task show
│ ├─● 38 Improve the currently split \\`nt show ID\\` and \\`nt ID\\` command handling […]
│ ├─● 43 Add clone workspace command
│ ├─● 45 Improve task graph rendering
│ ├─● 46 Improve help output
│ └─○ 76 Add recursive option to unarchive command
└─◐ 17 Advanced features
├─● 16 Calculate and show completion progress recursively
│ ├─● 18 Implement task weights
│ └─● 49 Implement task priorities
├─○ 95 Improve task rendering options
│ └─○ 96 Add option to display task metadata such as priorities and weights
├─● 20 Add LLM analysis and inference integration
│ ├─● 77 Add basic LLM integration scaffolding
│ ├─● 78 Implement model management
│ │ ├─● 79 Allow creating and managing model configurations saved in global config
│ │ ├─● 80 Allow setting default active model in global config
│ │ └─● 81 Allow setting specific active model per workspace, but use global default if none set
│ ├─● 82 Implement query command for running LLM queries on tasks and task graphs
│ │ └─● 83 Design the most efficient and elegant UX for performing queries on tasks and structures
│ └─○ 88 Improved query UX
│ ├─○ 91 Clean up query UI and improve overall formatting
│ ├─○ 92 Add priorities and weights to LLM input
│ ├─○ 93 Add interactive query command shorthands
│ ├─● 89 Improve the query input and output rendering with a proper \\`nt/queryui.py\\` implementation
│ ├─● 90 Implementing streaming responses, so user doesn't have to wait for LLM feedback
│ ├─○ 94 Implement improved output/markdown rendering
│ └─○ 97 Add ability to include calculated progress in LLM input
├─○ 47 Search functionality
│ ├─○ 98 Traditional text/regexp based search
│ └─○ 99 Vector search
│ └─○ 100 Implement embedding generation
├─○ 32 File attachments
├─○ 54 Interactive mode
├─○ 44 Add clone task graph to other workspace
├─○ 13 Add time tracking […]
│ └─○ 14 Option to auto-stop tracking time when starting other task
│ └─● 3 Implement configuration
├─○ 29 Sync between devices
│ ├─○ 28 RNS networking core functionality
│ └─○ 53 Implement sync protocol
├─○ 30 Collaboration features
│ ├─○ 28 RNS networking core functionality
│ ├─○ 51 View other peers tasks
│ └─○ 52 Interact with other peers tasks
└─○ 48 Implement "pin" functionality
Inspect project progress:
T282828
❯ nt prg 7
◐ 7 Non-Linear Task Manager ⏵ 58.2% (34/62 tasks)
Type: composite
Auto-complete: All dependencies
Downstream: 61 dependencies
● Completed: 34
◐ In Progress: 2
○ Pending: 26
Attain the proper mood for completing those tasks you postponed:
T282828
❯ nt query 63 -r "Turn my unfinished tasks into haikus"
**Task 66: Paint roof**
Sky meets cracked tile gray,
A brush waits, paint untouched, cold—
Rain will come soon.
**Task 68: Check IP range documentation**
Paper trails in a drawer,
No map for where IPs should go—
Find the numbers now.
**Task 73: Shopping List → Superglue**
Superglue waits on shelf,
Broken things still need repair
No glue, no fix yet.
Served by rngit 1.4.1 - Generated in 0.05s